home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #2 / Monster Media No. 2 (Monster Media)(1994).ISO / graphics / pep15.zip / CHAPT13.TXT < prev    next >
Text File  |  1994-06-22  |  16KB  |  294 lines
  1. <Chapter 13:  Add-ons>
  2.      Add-ons are special purpose PEP components that are not copied from
  3. your disk into your computer's memory when you first load PEP. Instead, in
  4. order to maximize available memory and reduce loading time, these modules
  5. remain on disk until you use them the first time.
  6.  
  7.      When you invoke the ADD-ONS command, it displays a menu of the names
  8. of all files in the home directory with the extension ADD. Choose a name
  9. from this menu to load the corresponding add-on into PEP. The add-on will
  10. then be activiated and the appropriate add-on menu will be displayed.
  11. There are five add-ons supplied with PEP:
  12.  
  13.   The PCX add-on <[13.1]> exports pictures to bitmap files in the PCX
  14. format.
  15.   The TEXT add-on <[13.2]> imports ASCII text files into boxes with word
  16. wrap.
  17.   The FRAME add-on <[13.3]> generates decorative borders by replicating
  18. objects.
  19.   The GRID add-on <[13.4]> facilitates inserting grids of horizontal and
  20. vertical lines.
  21.   The PIC add-on <[13.5]> reads a 123/SYMPHONY graph file which becomes
  22. the open object.
  23.  
  24. <Section 13.1:  The PCX Add-on: PCX Output>
  25.      Use the PCX add-on to output (or export) a picture of the open object
  26. to a file in the PCX format. Pictures in PCX files are accepted by many
  27. word processors and publishing programs. By using the PCX add-on, you will
  28. be able to incorporate pictures drawn in PEP, into documents produced by
  29. any of these compatible packages.
  30.  
  31.      Note: the PCX pictures produced by PEP are monochrome, black and
  32. white images. Picture elements in background color are drawn white, and
  33. elements in any other color are drawn black.
  34.  
  35.      When running the PCX add-on, first use the ROTATION, STRETCHES,
  36. IMAGE, and WINDOW commands, if necessary, to define the properties of the
  37. image that you want to produce. These commands are similar to the
  38. corresponding commands that appear in the PRINT menu as described in
  39. Chapter <[6]>. Then use the OUTPUT command to enter a file name, and
  40. output a PCX image to that file.
  41.  
  42. <Section 13.1.1:  Output>
  43.      After you have specified the image that you want to export using the
  44. ROTATION, STRETCHES, IMAGE, and WINDOW commands described below, use the
  45. ADD-ONS/PCX/OUTPUT command to create a bitmap image according to these
  46. specifications, and to output it to a file. Type the command letter, and
  47. then enter a file name. A file is created with that name, and a bitmap
  48. image is written to the file in the PCX format. The file is given the
  49. extension PCX.
  50.  
  51. <Section 13.1.2:  Rotation>
  52.      Use the ADD-ONS/PCX/ROTATION command to export a rotated picture of
  53. the open object. Press the command letter to display a menu of the eight
  54. rotation options: 0, 90, 180, 270 (degrees clockwise), \, -, /, | (mirror
  55. images).
  56.  
  57. <Section 13.1.3:  Stretches>
  58.      Use the ADD-ONS/PCX/STRETCHES command to control the magnification
  59. applied to the open object when it is being written to the output file.
  60. This XY input command allows you to set either or both of the X and Y
  61. stretch factors. These numbers may be integers, decimals or fractions. The
  62. maximum stretch is 255.
  63.  
  64.      Note: the stretch factors are overridden when an output image size
  65. has been requested. A side effect of executing the STRETCHES command is to
  66. turn the image size override off.
  67.  
  68. <Section 13.1.4:  Image>
  69.      Using the ADD-ONS/PCX/IMAGE command, you can explicitly set the
  70. number of pixels wide and the number of pixels high that the exported PCX
  71. picture will be. There are two modes: ON and OFF. If the mode is ON, the
  72. output image is forced to be a specified size. When the open object is
  73. exported, PEP will ignore the stretch factors displayed in the PCX menu
  74. and calculate new ones. The new stretches are chosen so that the exported
  75. picture will have the required size. If the mode is OFF, the output image
  76. size is determined by the stretches and the size of the open object. The
  77. IMAGE command toggles the image mode between ON and OFF. When you turn
  78. IMAGE ON, the command becomes an XY input command so that you can set the
  79. horizontal (X) and vertical (Y) image size that you want PEP to produce.
  80. Note: executing the STRETCHES command described above automatically turns
  81. the image mode OFF.
  82.  
  83. <Section 13.1.5:  Window>
  84.      If you do not want to export the entire open object, you can use the
  85. ADD-ONS/PCX/WINDOW command to specify a rectangular sub-window which can
  86. then be exported. There are two windowing modes: OFF and ON. Press the
  87. command letter to toggle between these modes. The boundary of the window
  88. is given by four coordinates which appear in two sets of XY input lines
  89. under the command name in the menu. You can type in these numbers, using
  90. WINDOW as an XY input command.
  91.  
  92.      Or you can specify the window graphically using the cursor. Proceed
  93. as follows: press the command letter to turn windowing ON. Then position
  94. the cross-hair cursor at one corner of the desired window and press
  95. RETURN. The cross-hair is replaced by a stretchable box cursor. Position
  96. the mobile corner of that cursor at the opposite corner of the desired
  97. window and press RETURN again. The area outlined by the box cursor becomes
  98. the exported sub-window.
  99.  
  100. <Section 13.2:  The TEXT Add-on: Text Import>
  101.      The TEXT add-on can be used to import text into boxes in the open
  102. object with word wrap and to import text from a file into multiple
  103. objects. Use the FILE command to identify the source text file and the
  104. BOX-SIZE command to specify the size of box to receive the text. When the
  105. source file has been specified, a cross-hair cursor appears. Position this
  106. cursor at the upper left corner of the area you want to fill and press
  107. RETURN. Text from the file is imported and flows into a box of the
  108. specified size at the chosen point. If you prefer, you can change the
  109. cross-hair cursor into a box cursor of the appropriate size by pressing
  110. SPACE.
  111.  
  112.      If the source file contains more text, you can move the cursor and
  113. press RETURN again to continue the import at another point. If you leave
  114. the add-on to close the open object, the source text file remains open and
  115. you can continue the text import into a new object.
  116.  
  117.       The text box inserted is a GROUP. It acts as a single element for
  118. DELETE, MODIFY, and COLLECT operations. If you want to operate
  119. individually on the text lines that compose the box, you must first use
  120. the MODIFY/EXPLODE <[4.23]> command to ungroup it.
  121.  
  122. <Section 13.2.1:  File>
  123.      Use the ADD-ONS/TEXT/FILE command to specify the source text file.
  124. Press the command letter to display a menu of all files in the current
  125. directory with the extension TXT (or other extension set by the
  126. ADD-ONS/TEXT/EXT command below). Choose one to be the source for text
  127. import.
  128.  
  129. <Section 13.2.2:  Ext>
  130.      The ADD-ONS/TEXT/EXT command allows you to specify the file extension
  131. used by the ADD-ONS/TEXT/FILE command described above.
  132.  
  133. <Section 13.2.3:  Box-size>
  134.      Use the ADD-ONS/TEXT/BOX-SIZE command to set the width and depth of
  135. the box into which text will flow. This is an XY input command.
  136.  
  137. <Section 13.2.4:  Modify>
  138.      The ADD-ONS/TEXT/MODIFY command automatically selects the most
  139. recently created box of imported text and displays a MODIFY menu for it.
  140. You can now change as many of the properties of this element as you want.
  141. Since text boxes produced by this add-on are PDL groups, the modify menu
  142. appropriate for groups is displayed, although some commands (for example,
  143. FILL) are not relevant in this context. (See Chapter <[4]> for a
  144. description of each of the commands available in the different MODIFY
  145. menus.)
  146.  
  147. <Section 13.3:  The FRAME Add-on: Decorative Borders>
  148.      Using the FRAME add-on, you can add borders to the open object. You
  149. can control the size and position of the borders, and by nesting multiple
  150. borders, you can control the thickness and complexity. The FRAME add-on
  151. generates these borders by replicating objects in a rectangular pattern.
  152. One such rectangle is called a frame.
  153.  
  154.      Each frame produced by this add-on is a GROUP. It acts as a single
  155. element for DELETE, MODIFY, and COLLECT operations. If you want to operate
  156. on the individual objects that compose the frame, you must first use the
  157. MODIFY/EXPLODE <[4.23]> command to ungroup it.
  158.  
  159.      To create a frame, first use the BOX command to set the size and
  160. position of the border you want to create. Then use the FILE and OBJECT
  161. commands to construct the border.
  162.  
  163. <Section 13.3.1:  File>
  164.      Use the ADD-ONS/FRAME/FILE command to identify the source file for
  165. the objects from which the frame is to be constructed. Press the command
  166. letter to display a name menu of all files in the source directory with
  167. the extension PDL and choose a source file from this menu.
  168.  
  169.      The source directory may be either the current PEP directory or the
  170. PEP home directory. The choice is determined by the
  171. ADD-ONS/FRAME/DIRECTORY command below.
  172.  
  173.      Collections of objects specifically designed for creating frames have
  174. been included with PEP. These are the files FRAMEx.PDL. Of course, you can
  175. also use objects from any other files to construct frames including
  176. objects that you have created yourself. However, note that new objects
  177. must first be saved to a file on disk before they can be accessed by the
  178. FRAME add-on.
  179.  
  180. <Section 13.3.2:  Object>
  181.      Use the ADD-ONS/FRAME/OBJECT command to select an object from the
  182. source file and construct a border by replicating it. If an object with
  183. that name is already present in the loaded PDL file, that object is used
  184. to construct the frame. Otherwise, the object you chose is first imported
  185. from the source file, and then used to build the frame.
  186.  
  187.      Once an object has been specified, FRAME checks the source file for a
  188. companion object to use at the corners of the frame. By convention, the
  189. name of a companion object is the tilde character (~) followed by the
  190. original object name. If no companion object is found, the original object
  191. is used for both the edges and the corners of the frame.
  192.  
  193.      Use the OBJECT command a second time if you want to construct another
  194. frame immediately inside the one just created. This new frame is nested
  195. within the old one. Any number of frames may be so nested to create a
  196. border of arbitrary thickness and complexity. The border shown in
  197. <[FIG19]> is made up of three nested frames. To construct a new frame
  198. which is not nested, simply use the BOX command described below to define
  199. a new position for the next constructed frame.
  200.  
  201. <Section 13.3.3:  Box>
  202.      Use the ADD-ONS/FRAME/BOX command to define the size and position of
  203. the frame to be created. Press the command letter, position the
  204. stretchable box cursor, and press RETURN. The next created frame is
  205. constructed inside the box so defined. Alternatively, the four coordinates
  206. defining the box can be typed directly into either or both of the two XY
  207. coordinate pairs following the BOX command menu item.
  208.  
  209. <Section 13.3.4:  Replace>
  210.      Use the ADD-ONS/FRAME/REPLACE command to replace the most recently
  211. created frame with another. Press the command letter to enable replacing,
  212. then use the OBJECT command above to construct a new frame which then
  213. replaces the old one.
  214.  
  215. <Section 13.3.5:  Directory>
  216.      Use the ADD-ONS/FRAME/DIRECTORY command to select the directory
  217. containing the source files for frame objects. This is a multiple choice
  218. command. The choices are: HOME (source files are located in the PEP home
  219. directory) and CURRENT (source files are located in the current
  220. directory). You may want to construct frames with objects from either the
  221. PEP standard libraries or libraries of your own creation. This command
  222. provides a rapid method of switching between the relevant directories. The
  223. current directory can be changed by using the SETUP/DIRECTORY menu
  224. <[12.6]>.
  225.  
  226. <Section 13.4:  The GRID Add-on: Graph Paper>
  227.      The GRID add-on can be used to insert grids of horizontal and
  228. vertical lines into the open object. First use the NUMBER command to
  229. specify how many rows and columns you want and use the UNITS command to
  230. specify the width and height of a grid cell. Then position the cross-hair
  231. cursor and press RETURN. A grid of horizontal and vertical lines is
  232. inserted with its upper left corner placed at the cursor position. If you
  233. prefer, you can change the cross-hair cursor into a box cursor of the
  234. appropriate size by pressing SPACE.
  235.  
  236.      The grid is a GROUP. It acts as a single element for DELETE, MODIFY,
  237. and COLLECT operations. If you want to operate individually on the
  238. horizontal and vertical lines that compose the grid, you must first use
  239. the MODIFY/EXPLODE <[4.23]> command to ungroup it.
  240.  
  241. <Section 13.4.1:  Number>
  242.      The ADD-ONS/GRID/NUMBER command is an XY input command. Use it to set
  243. the number of grid spaces required horizontally and vertically. X equals
  244. the number of columns in the grid, and Y equals the number of rows.
  245.  
  246. <Section 13.4.2:  Unit-size>
  247.      The ADD-ONS/GRID/UNIT-SIZE command is an XY input command. Use it to
  248. set the grid line spacing horizontally and vertically. X equals the width
  249. of one grid cell, and Y equals the height
  250.  
  251. <Section 13.4.3:  Modify>
  252.      The ADD-ONS/GRID/MODIFY command automatically selects the most
  253. recently created grid and displays a MODIFY menu for it. You can now
  254. change as many of the properties of this element as you want. Since the
  255. grids produced by this add-on are PDL groups, the modify menu appropriate
  256. for groups is displayed, although some commands (for example, TEXT/FONT)
  257. are not relevant in this context. (See Chapter <[4]> for a description of
  258. each of the commands available in the different MODIFY menus.)
  259.  
  260. <Section 13.5:  The PIC Add-on: Lotus Graph Import>
  261.      Use the PIC add-on to import PIC format graph files created by Lotus
  262. 1-2-3 and Symphony.
  263.  
  264.      The registered version of PEP includes a special font file, LICS.FON,
  265. that supports the Lotus International Character Set. LICS.FON is similar
  266. in appearance to BORIC.FON, but the bold and italic characters have been
  267. replaced by the extended characters of the LICS set. If an imported PIC
  268. graph file contains international characters, you can display these in PEP
  269. by installing the LICS font as PEP font 0 or 1. (See SETUP/INSTALL/0-FONT
  270. <[12.5.1]>). Normally, the first title in a PIC graph uses font 0, and all
  271. other text uses font 1. Note: the LICS font is not part of the shareware
  272. PEP package.
  273.  
  274. <Section 13.5.1:  Load>
  275.      The ADD-ONS/PIC/LOAD command displays a name menu of all the files in
  276. the current directory with the extension PIC. Use it to choose the PIC
  277. file you wish to import. The imported PIC data becomes the open object.
  278. The former contents of the open object are lost.
  279.  
  280. <Section 13.5.2:  Size>
  281.      Use the ADD-ONS/PIC/SIZE command to control the size of the imported
  282. PIC file images. You may set a size explicitly, or import the file in its
  283. native size.
  284.  
  285. <Section 13.5.3:  Patterns>
  286.      When you import a PIC file, you can optionally convert solid fill
  287. regions into pattern fill. This feature is useful for adapting color PIC
  288. files for black and white printing. The ADD-ONS/PIC/PATTERNS command is a
  289. multiple choice command with two values: ENABLED and DISABLED. Press the
  290. command letter to toggle between these two choices. If PATTERNS are
  291. ENABLED (the default choice), then solid regions in the PIC data are
  292. automatically converted to pattern fill. The pattern used is determined by
  293. the color of the region.
  294.